Getting Started With OpenStack: Install your cloud 


OpenStack doesn't have a built-in deployment tool. Instead, several tools exist, with different purposes. You will deploy a 
simple OpenStack cloud with the help of Devstack. It is a light-weight deployer suitable for proof-of-concept or educational 
clouds that run on virtual machines on PCs. Devstack requires fewer resources than Packstack, but is still highly 
configurable, especially compared to Microstack. 


Its downsides: A weird configuration file and its dependency on upstream Python software rather than curated packages. 
It is also not designed for rebooting, but this can be overcome with some shell scripting. 


What you need 

e A machine with 10GB RAM and 50GB storage. A virtual machine is strongly recommended. 
Use as much RAM as you can afford. 8GB might work as well. 

e |f your machine is virtual, expose the physical CPU's virtualization features to the virtual CPU. This is commonly 
called nested virtualization. It is not mandatory but without it, your OpenStack VMs will run extremely slowly. 
See documentation for Virtualbox and documentation for KVM (the latter is from the Fedora project but applicable to 
other distros as well). 

e An ISO file for Ubuntu 18.04. 

e |f your main PC runs Windows, install an SSH client for accessing the cloud's command line. Putty and MobaXTerm 
are popular solutions. 


Install and configure Ubuntu 

Install Ubuntu 18.04. Don't install desktop software, and don't enable any services except OpenSSH. The Ubuntu installer 
asks you for a non-privileged user; name it stack. Use the simplest storage configuration possible - no LVM, single 
partition. 


After installation, configure passwordless sudo for user stack, for example 


$ echo "stack ALL=(ALL:ALL) NOPASSWD:ALL" | sudo tee /etc/sudoers.d/stack 


In /etc/netplan, set a static IP and gateway. If you are new to Netplan, the static addressing example at 
htips://netplan.io/examples/ helps. Here is my configuration: 


$ cat /etc/netplan/5@-cloud-init.yaml 
network: 
ethernets: 
ens3: 
addresses: 

- 192.168.1.207/24 
gateway4: 192.168.1.1 
nameservers: 

search: [home] 

addresses: [192.168.1.16, 1.1.1.1] 

version: 2 


In /etc/systemd/resolved.conf, set your DNS servers. 
Update the network configuration: 


$ sudo netplan apply 
$ sudo systemctl restart systemd-resolved 


Set your time zone and update the software. 


$ timedatectl set-timezone Asia/Tokyo 
$ apt update && apt upgrade -y 


If your machine is virtual, it's advisable to take a snapshot now. In case your Devstack installation failes, you can revert to 
the snapshot instead of reinstalling everything - a great time saver. One problem when reverting to a snapshot is the 
machine's time, which might be several hours in the past. This will lead to various errors. Therefore, after reverting to the 
snapshot check and correct the time if necessary. 


Install Devstack 


Log on as user stack, then clone the Victoria version of Devstack. 


$ cd 
$ git clone http://opendev.org/openstack/devstack -b stable/victoria 


Copy local. conf to ~stack/devstack, then 


$ cd devstack 
$ ./stack.sh 


The time it takes to complete the script depends on the speed of your internet connection, since it downloads large 
amounts of data. The disk, CPU and memory specs of the machine are important factors as well. Count 30 to 90 minutes. 


If everything goes right, the script indicates success like this: 


DevStack Component Timing 
(times are in seconds) 


run_process 25 
test_with_retry 4 
apt-get-update 5 
OSC 224 
wait_for_service 19 
dbsync 35 
pip_install 135 
apt-get 13 
Unaccounted time 505 
Total runtime 965 


This is your host IP address: 192.168.1.207 

This is your host IPv6 address: ::1 

Horizon is now available at http://192.168.1.207/dashboard 
Keystone is serving at http://192.168.1.207/identity/ 

The default users are: admin and demo 

The password: pw 


Services are running under systemd unit files. 
For more information see: 
https://docs.openstack.org/devstack/latest/systemd.html 


DevStack Version: victoria 

Change: 08e5dc99e696377db1f11626d0084320ffc5bdd6 Merge "Fix DevStack setup on CentOS 8.3" into 
stable/victoria 2021-03-25 19:20:14 +0000 

OS Version: Ubuntu 18.04 bionic 


If your installation is not successful, the most likely cause is a typo in local. conf. Occasionally, there are glitches in the 
software that stack.sh installs. Depending on the type of error, you can simply re-run stack.sh, but often, you are better 
off reinstalling the operating system, then running stack.sh again. 


After the installation 
As mentioned, Devstack does not take reboots well because its network and storage configuration is not entirely 
persistent. To address this problem, first make the following changes to the /etc/netplan configuration: 


e replace the NIC's name with br-ex 
e create an empty configuration for the NIC, so that it is enabled. 


e Inthe following example, the NIC is ens3. Sinc it is now plugged into br-ex, the IP address and other details are 
configured on br-ex. Reflect that change in the netplan file. To enable the NIC, it needs to be listed with an empty 
configuration. 

$ cat /etc/netplan/50-cloud-init.yaml 

network: 
ethernets: 


ens3: {} 
br-ex: 
addresses: 
- 192.168.1.207/24 
gateway4: 192.168.1.1 
nameservers: 
search: [home] 
addresses: [192.168.1.16, 1.1.1.1] 
version: 2 


Due to a bug, the original Ubuntu 18.04 ignores the empty configuration ens3: {}. If you upgraded Ubuntu after its 
installation, the bug should have been removed. 


This takes care of the network configuration. You also need to fix storage: A filesystem for Swift must be mounted, and 
two loop devices have to be created to server as Cinder's physical volumes. The script below performs the necessary 
steps; you can either run it manually after a reboot, or copy it to /etc/rc.local (and ensure that rc.local is executable). 


$ cat ~/restore-after-reboot 


Adapt the image catalog 
You will launch Wordpress on Fedora. As a side-effect of the Heat installation in your Devstack cloud, you should have a 
Fedora image in the catalog already. Become admin and check this. 


$ source ~/devstack/openrc admin admin 
$ openstack image list 


If a Fedora image exists, change its name to fedora for convenience. The command below assumes that the image is 
originally named Fedora-Cloud-Base-32-1.6.x86_64, which may not be the case in your cloud. 


$ openstack image set Fedora-Cloud-Base-32-1.6.x86_64 --name fedora 
$ openstack image list 


If your catalog does not include a Fedora image, download one from the Fedora project and add it to the catalog. The 
example below uses Fedora 32; by the time you read this, a newer version should be available. 


$ wget https://download.fedoraproject.org/pub/fedora/linux/releases/32/Cloud/x86_64/images/Fedora-Cloud- 
Base-32-1.6.x86_ 64.qcow2 
$ openstack image create --file Fedora-*.qcow2 --disk-format qcow2 --public fedora 


Also rename the Cirros image. 
$ openstack image set cirros-@.4.0@-x86_64-disk --name cirros 
Become demo and check if you can see the two images. 


$ source ~/devstack/openrc demo demo 

$ openstack image list 
+-------------------------------------- +-------- +-------- + 
| ID | Name | Status | 
+-------------------------------------- +-------- +-------- + 
| f7c131ab-1bbe-44b6-acd8-1b078249b3bf | cirros | active | 
| @c6a4c42-1132-4727-bff5-6320cecbef97 | fedora | active | 
+-------------------------------------- +-------- +-------- + 


